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ProSang introkurs 


PROJEKT 




W 



W 



Project 


ponor Administration 


► Liä Source Packades 

► Qd TestPackages 

► Cd Other Sources 

► Cd Other Test Sources 

► Cj Ubraries 

► Lji Test Ubraries 

▼ Q Important Files 
► E>) XML Layer 

@ Module Manifest 
H Module Oescnptor 

▼ laJ Project Files 

15 ) pom.xml 
Hl settmgs.xml 


Files 


Donor Administration 


▼ Q src 

▼ CJ ma in 

► Q java 

► L_ nbm 

► Q resources 

▼ LJ test 

► Q java 

► Q resources 

► CJ target (Iqnored ] 

Hl nb-configuration. xml 
H| nbactions.xml 
Hl pom.xml 


Filstrukturen i mavenprojekt ser i princip alltid lika ut. I NetBeans visas en projektvy där olika 
typer av kataloger från våra projekt grupperas ihop. NetBeans har också en filvy där man kan 
se hur katalogerna och filerna faktiskt är ordnade på hårddisken. 

Source Packages innehåller själva javaklasserna. Här finns aldrig något annat än javaklasser 

Test Packages innehåller javaklasser med unittester för klasserna från Source Packages 

Other Sources innehåller resurser.T.ex. textfiler, xml-filer, .properties-filer, bilder. 

Other Test Sources resurser som bara behövs för unittesterna. 

Libraries är ingen riktig katalog utan visar projektets externa beroenden. De faktiska 
beroendeposterna är listade med <dependency>-block i projektets pom.xml 

Test Libraries samma sak men innehåller de bibliotek som bara behövs när testerna körs. 

Important Files - NetBeans RCP-specifika konfigurationsfiler, layer.xml som låter oss 
publicera funktioner i våra moduler så att de kan användas av NetBeans RCP. 

Project Files - Mavens konfigurationsfiler, pom.xml är från projektet men settings.xml är en 
genväg till din lokala inställningsfil som egentligen ligger i $HOME/.m2/settings.xml 
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ProSang introkurs 


NETBEANS 



ProSang-klienten är byggd ovanpå NetBeans RCP (Rich Client Platform). NetBeans RCP är en 
opensourceplatform för att bygga grafiska Javaapplikationer som ägs och utvecklas av Sun/Oracle. 
Utvecklingsmiljön NetBeans IDE bygger precis som ProSang på NetBeans RCP. 

En applikation som skrivs för NetBeans RCP är uppbygd av smådelar som kallas moduler 


(.n.bm-filer),. 

ProSang 


i 


Givar¬ 

administration 


|=L 



=n 

Givarbokning 


=□ 

Skärm¬ 

komponenter 


□ 

Fönster¬ 

hantering 


Skärmar 


Stödmoduler 


DD 

m 

J3 

O 

m 


o 

m 


NetBeans RCP 


I ProSang är modulerna uppdelade i olika kluster.Vi har ett kluster som heter Core som 
innehåller moduler med komponenter och API.er som är gemensamma för hela ProSangklienten. 

För varje rutin (Administration, Givare, Patient etc.) finns sedan ett eget kluster. Modulerna 
som innehåller själva skärmarna skall inte dela med sig någon funktionalitet till andra moduler 
Gemensam funktionalitet som bara berör modulerna i ett kluster placeras i en modul som heter 
common i klustret. Funktionalitet som är generell för hela klienten placeras i olika moduler under 
core-klustret. Exempel på det är ProSangs sök-API, resultat-API. 

Moduler har ett rikare stöd för att tala om vilka klasser som är till för omvärlden än vanliga 
jar-filer. Man bör bara dela ut de paket som innehåller genomtänkta publika APIrer.Vilka paket som 
är publika ställer man in i modulens pom.xml 


<plugin> 

<groupId>org.codehaus.mojo</groupId> 

<artifactld>nbm-maven-plugin</artifactld> 

<extensions>true</extensions> 

<configuration> 

<publicPackages> 

<!-- All other packages are private to the module --> 
<item>se.databyran.prosang.mymodule.package.**</item> 
</publicPackages> 
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ProSang introkurs 


PROGRAMA 



ProSang består av en mängd delprogram 
som tillhandahåller olika funktioner till olika 
personer på blodcentralen. Sådana 
delprogram kallas för åtgärdskoder efter 
den kod de startas med. En sådan kod kan 
se ut såhär t.ex. ”G 100”. G står för 
Givarrutin och 100 är en unik identifierare 
för vilket givarprogram det handlar om. 

Varje åtgärdskod i ProSang är 
implementerad med en subklass till Program 
som talar om vilken kod, vilken ikon och vad 
programmet heter. Klassen har också en 
metod som anropas när åtgärdskoden 
startas och som öppnar själva skärmen för 
åtgärdskoden. 

För att ProSang skall hitta programmet 
och visa det i programträdet måste 
programklassen registeras som 
implementation av SPI:t (Service Provider 

Interface) i en fil under META-INF/services som heter samma sak som själva SPI-interfacet den 
implementerar. 

För ett program heter filen såhär: 



META-INF/services/se.databyran.prosang.Client.core.program.spi.Program 


Registreringsraden för ett program i filen kan se ut såhär: 
se.databyran.prosang.Client.addressbook.AddressBookProgram 


Samma modul kan innehålla flera program, de listas i samma fil med en ny rad för varje 
program. I NetBeans hittar du registreringsfilen under ‘Other Sources’: 

▼ iZifc/ Donor Adminisiratlon (nbm) 

► Lä Source Packages 

► Lä Test Packages 
▼ Gg Other Sources 

► Cj nbm 

▼ Lä src/main/resources 
▼ Lid META-INF.services 

lJ se.{Jdtabyran.prosang.Client.core.program.spi.Program 
[j se.databyran.prosang.model.spi.user.AccessPermissionManager 
► Lid se.databyran.prosang.Client.donor.administration alerts 
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ProSang introkurs 


Programmet 

Hello World! 

Säg att vi höll på att skriva programmet ”G00I Adressboksprogrammet”, då skulle vår 
programklass kunna se ut såhär: 


public class AddressBookProgram extends Program { 

public Programld getProgramId() { 

return new ProgramId(ProgramCategory.DONOR, "001"); 

} 

public String getLabelO { 

return "Addressboksprogrammet"; 

} 

protected IconType getlconO { 

return IconType.ADDRESSSMALL; // hittepå 

} 

public String getDescription() { 

return "Hantera addresser till vänner och bekanta"; 

} 

protected void startProgram() { 

System.out.println("Hello world!"); 

} 




ProSang introkurs 


I18N är en 
förkortning för 
internationalization 
som innehåller 18 
bokstäver mellan I 
och N. 

.properties-filerna 
syntax kommer från 
javas klassbibliotek 
och kan läsas och 
skrivas med klassen 
Properties. 

Locale är en 
kombination av land 
och språk (vissa 
länder har flera 
språk) som t.ex. kan 
se ut så här för 
sverige ”sv_SE” 


I 18 N 

Alla strängar som visas för användaren i ProSang måste internationaliseras. 
Java har inbyggt stöd för internationalisering med Bundle-API:t men vi 
använder ett bibliotek ovanpå det som kommer från NetBeans RCP. Själva 
texterna ligger i enkla textfiler med nyckel och text till varje sträng.Varje språk 
vi har stöd för finns i en separat sådan fil för varje java-paket i ProSang. 

Filnamnet talar om vilket språk som finns i den, med undantag för den 
propertiesfil som inte har något språk pålagd och som är standardspråket som 
java faller tillbaka på att använda ifall en nyckel saknas i språket applikationen 
körs på.Alla våra språkfiler skall ha ett namn som börja med ”Bundle”. 

Bundle.properties innehåller engelska, vilket kan tyckas lite märkligt 
jämfört med gamla prosang men tanken är att det skall underlätta den dagen vi 
behöver översätta till ett språk utanför norden. 


▼ Donor Admmtr«bon 

► Cd Sourct Puluges 

► uj T*ttP*c»io«$ 

▼ fr, Otf*r Soutmj 

► Q nbm 

▼ Q uc/nuin/r*sourc*s 
► (±1 META-INf.iervtcct 

▼ tid ve.daubyTAn.prosing.ttcnidonor.Mlintniurjuon.jitm 

► Bund K propert* s 

► «S Bundk.da prop*m*i 

► JS Bondie.no propert** 

► m Bundit .sv. SE.properties 


Java använder den locale som 
systemet är inställt för men man kan 
också trumfa det med en flagga som 
man skickar med när man startar en 
javaapplikation för att köra ett 
program på norska även om man kör 
datorn på svenska. Localen används 
också för att t.ex. formatera datum 
och tid på rätt sätt. 


Bundle.properties: 

MyTopComponent.title=My Top Component 

MyTopComponent.countField.text=There are {0} items in the list 

BundlesvSE.properties: 

MyTopComponent.title=Min toppkomponent 

MyTopComponent.countField.text=Det finns {0} saker i listan 


För att läsa filen använder man sedan NbBundle.getMessage(Class class, String keyName) 


NbBundle.getMessage(MyTopComponent.class, "MyTopComponent.title"); // N0I18N 
NbBundle.getMessage(MyTopComponent.class, 

"MyTopComponent.countField.text", // N0I18N 
5); 


Strängar som ligger i källkoden men som inte skall översättas skall markeras med // NOI I8N på 
så sätt kan vi hitta strängar som vi missat att översätta. Bundlenycklarna skall börja på klassen de 
används i och sedan vara någon form av objektsökväg till fältet som innehåller texten. 
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ProSang introkurs 


Loggning 

Ibland vill man skriva ut lite spårutskrift från sitt program. I java finns 
System.out.println som skriver en rad till standard out. Den skall man aldrig 
använda, istället skall man använda Log4J som är det log-paket vi använder för 
utskrift. 

Fördelen med att använda ett logpaket för utskrifter är att de vet var i 
koden logmeddelandet kom ifrån och att de går att styra och konfigurera på 
olika sätt. 


Lognivå 

Beskrivning 

ERROR 

Fel som inte går att kringå på något sätt och 
som leder till att programmet kraschar eller 
blir funktionsodugligt 

WARN 

Fel som programmet hanterar på något sätt 
men som borde åtgärdas 

INFO 

T.ex. hur en komponent är konfigurerad, när 
applikationen startas 

DEBUG 

Spårutskrifter som inte ger så mycket data. 

TRACE 

Spårutskrifter som inte ger massvis med 
data.T.ex. från insidan av en for-loop. 


Java innehåller ett 
eget log-API som är 
lite osmidigare att 
använda än Log4j. 
Dessutom är Log4j 
integrerat med 
JBoss som är vår 
applikationsserver. 


Loggningen knyts till vilken klass den kommer från när man skapar sin 
logger. I en konfigurationsfil styr man sedan vilka loggers meddelanden som 
skall skrivas till vilken logfil och vilka nivåer som skall filtreras bort. 

I ProSang-projektet finns en Log4J-konfiguration för utveckling som ligger i 
applikationsprojektet. Man kan också ansluta till en JMX-böna i ProSang- 
klienten för att ställa lognivåer i runtime. På serversidan finns en 
konfigurationsfil per serverinstans där man kan ställa lognivåer. Även där kan 
man ansluta till en JMX-böna för att ställa lognivåer i runtime. 


public class MyClass { 

private static final Logger LOGGER = 

Logger.getLogger(MyClass.class); 

public void myMethodO { 

LOGGER.info(”Entered my method"); // N0I18N 

try { 

someOtherMethod(); 

} catch (OtherMethodException ex) { 

LOGGER.warn(”Something failed", ex); // N0I18N 

} 
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ProSang introkurs 


Programmet 
Hello World! version 2 


public class AddressBookProgram extends Program { 


private static final Logger LOGGER = 

Logger.getLogger(AddressBookProgram.class); 

public Programld getProgramld() { 

return new ProgramId(ProgramCategory.DONOR, "001"); // N0I18N 

} 


public String getLabelO { 

return NbBundle.getMessage(AddressBookProgram.class, 

"AddressBookProgram.label"); // N0I18N 


} 


protected IconType getlconO { 

return IconType.ADDRESSSMALL; 

} 


public String getDescription() { 

return NbBundle.getMessage(AddressBookProgram.class, 

"AddressBookProgram.description"); // N0I18N 


} 


protected void startProgram() { 

LOGGER.info("Hello World!!!"); // N0I18N 

} 




ProSang introkurs 


STDRIVEN 



Att arbeta testdrivet innebär i princip att man aldrig skriver någon kod som inte 
är till för att få ett test att gå igenom. Genom att börja med ett ett grundläggande 
test och sedan skriva kod som får testet att gå igenom och sedan utöka testet 
med komplexare och komplexare krav på funktionalitet så hjälper man sig själv 
och andra på ett antal sätt: 

• Det blir ett kvitto på att det man kodat faktiskt fungerar, som till skillnad 
från ett manuellt test går att återupprepa kontinuerligt och dessutom 
oerhört mycket snabbare varje gång 

• Det blir ett skyddsnät för dig själv och andra som visar att ny funktionalitet 
inte föstör något som fungerade förut 

• Det är en form av dokumentation som visar hur ditt publika API är tänkt 
att användas 

• Det hjälper dig att tänka som en konsument av den tjänst du håller på att 
implementera, är mitt publika API verkligen vettigt att använda? 

• Testbar kod är ofta kod som är bättre designad än kod som inte går att 
testa. 

Därför är det extremt viktigt att du hela tiden fösöker arbeta testdrivet. 

En testmetod skall vara isolerad och inte påverkas av andra tester och inte 
heller påverka andra tester.Testet skall namnges så att det går att utläsa som den 
funktion det testar. 


import static org.junit.Assert.*; 
public class MyClassTest { 

@Test 

public void beforeAnySearchHasBeenPerformedTheResultIsNull() { 

Searcher instance = new SearcherO; 

String result = instance.getResult(); 

assertNotNull(result); 

} 


För att unittesta våra klasser använder vi JUnit 3 och 4 som är väl 
integrerade med NetBeans IDE och Maven. 

Testerna körs varje gång projektet byggs och på så sätt kan vi vara säkra på 
att vi upptäcker fel som vi skapar i kod som förut fungerat utan att manuellt 
validera funktioner varje gång vi ändrar något. 

Testerna körs också på vår ci-server http://smith.databyran.local:9000/ 
hudson efter varje incheckning till källkodsrepositoriet. 
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ProSang introkurs 


SKAPAENSKÄRM 


ProSangTopComponent 

s 





Program 


ProgramTopComponent 



A 





MyProgram 


MyTopComponent 



Begreppet 
TopComponent 
kommer från 
NetBeans RCP som 
har en egen 
fönsterhanterare 
som sköter de 
interna fönstren i en 
NetBeans RCP- 
applikation. 


Nästan varje program i ProSang har en skärm.Varje sådan skärm ärver 
ProgramTopComponent. 

NetBeans guide för att skapa topkomponenter lägger till en massa text i olika 
konfigurationsfiler som vi inte vill ha och vi har ingen egen mall för 
topkomponenter. Istället skapar man en nyJPanel (som man kallar 
MittProgramNamnTopComponent) och ändrar så att den ärver 
ProgramTopComponent i java-koden. 
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ProSang introkurs 


Programmet 

Skapa och starta skärmen 


public class AddressBookProgram extends Program { 

public Programld getProgramld() { 

return new ProgramId(ProgramCategory.DONOR, "001");; 

} 

public String getLabelO { 

return NbBundle.getMessage(AddressBookProgram.class, 

"AddressBookProgram.label"); 

} 

protected IconType getlconO { 

return IconType.ADDRESSSMALL; 

} 

public String getDescription() { 

return NbBundle.getMessage(AddressBookProgram.class, 

"AddressBookProgram.description"); 

} 

protected void startProgram() { 

ProgramTopComponent topComponent = new AddressBookTopComponent(); 
run(topComponent); 

} 



Topkom ponenten 


public class AddressBookTopComponent extends ProgramTopComponent { 


public AddressBookTopComponent() { 
initComponents(); 

setModel(presentationModel); 
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ProSang introkurs 


KOMPONENTER 


ProSangs specialkomponenter 


Komponent 

Beskrivning 

ProSangSimpleList 

En tabell med data för visning, enkelt 

API för knappar som utför operationer 
på listan 

ProSangTextField 

Textfält med funktioner för 
formattering, validering och notifiering 

ProSangDatePickerField 

Datumväljare med kalender 

DefinitionSelector 

Autokompletekombobox för 
definitioner 

EnumSelector 

Autokompletekombobox för enums 

ProSangDualList 

Två listor, en med möjligt urval och en 
med de som är valda. 


De flesta komponenterna i ProSang 
kommer från modulerna Client 
Modules/Core Utilities och Client 
Modules/Core Components. För att 
kunna rita skärmar med ProSangs 
specialkomponenter måste du själv 
lägga till dem genom att i skärmritaren 
högerklicka på paletten och välja 
”Palette Manager”. 

Skapa sedan en kategori som heter 
ProSang som du kan placera alla 
ProSang-komponenter i och lätt hitta 
dem. 

Klicka sedan på ”Add from jar...”, 
leta upp jarfilen för ”Core Utilities” på 
din hårddisk. När du valt jarfilen 
kommer du få upp en jättelång lista med klassnamn. NetBeans kan inte skilja på vilka klasser 
som är skärmkomponenter och vilka som är vanliga klasser så du får leta fram 
komponenterna du vill lägga till. Listan ovan är en bra startpunkt. 

Gör samma sak med Core Components. 
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ProSang introkurs 



EROMS 








PresentationModel 


Alla skärmar med data och knappar kan sägas ha ett tillstånd.Tillståndet kan 
vara en lista med objekt som syns i skärmen eller om en knapp går att klicka 
på. Det är också operationer som knappar utför. 

För att underlätta testning och spaghetti-kod i skärmklasserna 
representerar vi alltid skärmens innehåll och tillstånd med en subklass till 
StandardPresentationModel. 

FormState 

Alla skärmar med data som går att förändra på något sätt har ett 
skärmtillstånd.Vi har gjort en representation av detta med klassen FormState. 

Ett formstate kan vara oförändrat, ändrat, innehålla fel eller både vara 
ändrat och innehålla fel. Ofta skall t.ex. en ok-knapp vara omöjlig att klicka på 
om inget ändrats eller om något ändrats men skärmen innehåller ett fel. 

FormState gör det möjligt för våra skärmar att kontinuerligt veta om de 
innehåller fel och förhindra att man ens kan klicka på t.ex. Ok-knappen så länge 
skärmen inte innehåller ändringar eller innehåller fel. 


public class AddressBookTopComponent extends ProgramTopComponent { 


public AddressBookTopComponent() { 
initComponents(); 

FormState formstate = new MockFormState(); 
setFormState(formState); 
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ProSang introkurs 


Listor 

Glazed Lists 



I många skärmar vill vi ha filtrering av tabeller och möjliga val i komboboxar. Vi vill också 
kunna förändra listors innehåll så att listor som finns i skärmen uppdateras. 

De listor som finns i javas klassbibliotek saknar stöd för det.Vi använder därför ett 
bibliotek som heter Glazed Lists som utökar javas Collection-API med listor som avfyrar event 
när objekt i listan läggs till, flyttas eller tas bort (med lite special även om egenskaper på objekt 
i listan ändras) 

Våra tabeller är helt byggda kring glazed lists listor. 

Eventlistpaketet använder trådar bakom kulisserna så för att göra dem trådsäkra behöver 
du låsa dem innan du förändrar dem, annars kan du få konstiga trådfel eller 
ConcurrentModificationException. 


EventList<Person> addressBook = new BasicEventList(); 


public void clearAddressBook() { 

addressBook.getReadWriteLock().writeLock().lock(); 
addressBook.clear(); 

addressBook.getReadWriteLock().writeLock().unlock(); 

} 
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ProSang introkurs 


Filtrering 



EventList<Person> addressBook = new BasicEventList(); 

EventList onlyAPersons = new FilterList(list, new Matcher<Person>() { 

public boolean matches(Person person) { 

return person.getName().startsWith("A"); 

} 

}) 


Om man har en statisk filtrering (där det man filtrerar med inte förändras) sätter man en 
matcher på sin filterlista. 

När man vill ha ett formulär som filtrerar om listan gör man det med en MatcherEditor. 
MatcherEditorn skapar en ny Matcher och informerar listan om att sökvilkoren förändrats så 
att listan filtreras om. Man kan även sätta en ny Matcher på filterlistan direkt om man har 
tillgång till den. 


private FilterList<Person> addressBook = ... 


private void setSearchText(String searchText) { 

addressBook.setMatcher(new NameMatcher(searchText)); 

} 
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ProSang introkurs 


TableFormat 

Hur skall tabellen se ut? 

För att styra vilka kolumner som skall finnas i en tabell skapar man en 
ColumnsTableFormat och i den stoppar man enTableColumn för varje kolumn som tabellen 
skall ha. 


Kolumnens innehål] 


private ProSangTableFormat createTableFormat() { 

TableColumn nameColumn = new TableColumn<Address, String>( 

"Namn", \ 

50, V 

String.class) { ^- Tabellens innehåll 

public String getValue(Address address) { 
return address.getName(); 

} 


TableColumn streetColumn = new TableColumn<Address, String>( 
"Gata", 

50, 

String.class) { 


} 


public String getValue(Address address) { 
return address.getStreet(); 

} 


return new ColumnsTableFormat<Address>(new TableColumn[] { 

nameColumn, streetColumn}); 


Många tabellkolumner återkommer i flera tabeller, sådana kolumner för t.ex. givare kan du 
hitta i modulerna Donor Common eller CoreTables. Om du skapar en kolumn som du kan 
tänka dig kommer behövas på fler ställen, tänk på att stoppa den i någon av de moduerna! 
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ProSang introkurs 


ProSangSimpleList 

Koppla ihop listan med skärmen 

För att visa en lista i skärmen använder vi vår egen komponent ProSangSimpleList. Du 
sätter upp innehållet i din skärm i konstruktorn. Eftersom listan avfyrar event när innehållet 
förändras skall du göra detta även om din lista får data först senare. 


public class AddressBookTopComponent extends ProgramTopComponent { 

public AddressBookTopComponent() { 
initComponents(); 

addressSimpleList.setup(model.getAddresses(), createTableFormat()); 

} 


ProSangSimpleList är förberedd med de vanligaste knapparna (lägg till, ta bort och 
redigera). Så för att skapa en sådan lista registrerar man bara olika callbacks för lägg till och 
ändra.Ta bort kan den sköta helt själv men du kan behöva skapa en ObjectRenderer för att 
göra om raden som tas bort till en användarvänlig text (”Vill du verkligen ta bort..”). 

Om man har mer specifika knappbehov så kan man implementera interfacet 
ButtonDescription och skicka in till sin ProSangSimpleList. 


public class AddressBookTopComponent extends ProgramTopComponent { 

public AddressBookTopComponent() { 
initComponents(); 


addressSimpleList.setItemCreator(new ItemCreator() { 
public Object create() { 

// TODO show a dialog 

} 

} 

addressSimpleList.setItemEditor(new ItemEditorO { 
(aOverride 

public Object edit(Object original) { 

// TODO copy object, show dialog 

} 

}); 

} 
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ProSang introkurs 


DIALOGA 



DialogFactory är ett 
lite olyckligt namn 
eftersom det inte 
alls är någon 
factory utan snarare 
en statisk 
utilityklass. Bakom 
kulisserna anropar 
den NetBeans 
platforms dialog 
API. 


Dialogfabriken 

För att alla dialoger i ProSang skall se likadana ut så skall alla knappar visas 
med hjälp av klassen DialogFactory. För enkla dialoger som sådana med en 
fråga och ett par knappar finns särskilda metoder. I de fall en mer komplicerad 
dialog behöver visas kan man skicka in en egen panel till DialogFactory, panelen 
innehåller då inte knapparna som skall finnas i nederkanten av dialogen utan 
dem skickar man med som ett separat argument till DialogFactory. 

Precis som skärmar har dialoger med egna paneler ett skärmtillstånd 
(FormState) som t.ex avgör om man kan klicka på ok eller inte. För att 
automatiskt knyta ihop en panel med dialogknapparna 


// simple dialogs 

DialogResult result = DialogFactory.yesl\loCancelDialog("titel", "fråga"); 
if (result == DialogResult.YES) { 

// save 

) 


boolean yes = DialogFactory.yesl\loDialog("titel", "fråga"); 


boolean ok = DialogFactory.okCancelDialog("titel", "påstående"); 


DialogFactory.warningDialog("varning"); 


// dialog with custom panel 
MyCustomPanel panel = new MyCustomPanel(); 
if (DialogFactory.okCancelDialog("titel", panel)) { 
Address value = panel.getAddress(); 

// save value 

} 


19 








ProSang introkurs 


Beans binding 
startades som 
JSR 295 men har 
sedan dess 
torkats till 
BetterBeansBindi 
ng. Vi kör vår 
egen patchade 
version av beans 
binding. 


BeansBinding 

Synkronisera bönor 



För att knyta ihop presentationsmodellen med skärmen använder vi ett 
bindningsframework som heter BeansBinding. Beansbinding använder javas 
PropertyChange-API för att upptäcka att ett fält på ett objekt ändrats och 
sedan synkronisera värdet med ett fält i ett annat objekt. 

För att ändringar av värdet på ett fält skall upptäckas måste det uppfylla 
några krav som kommer från en gammal java-komponent-spec som heter 
JavaBeans. Ett fält som uppfyller dessa krav kallas ibland för en property - då 
avses både själva fältet, gettern och settern. 


public class MyClass { 

private final PropertyChangeSupport propertyChangeSupport 

= new PropertyChangeSupport(this); 

public static final St ring PROPTEXT = "text"; 

private String text; 

public String getTextO { 
return text; 

} 


public void setText(String text) { 

String oldText = this.text; 
this.text = text; 

propertyChangeSupport.firePropertyChange( 

PROPTEXT, oldText, text); 


} 


För att vara en property måste fältets getter heta get FältetsNamn (eller 
is FältetsNamn om det är en boolean) och settern set Fältnamn, du skall också 
deklarera en public strängkonstant som innehåller fältnamnet som heter 
PROP_FÄLTETS_NAMN så att externa klasser slipper hårdkoda fältets namn 
om de lyssnar efter ändringar av fältet. 
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Skärmritaren håller 
två filer i sync. En 
XML-fil som 
beskriver skärmen 
och en Java-klass 
med ett par 
segment som inte 
går att ändra 
genom NetBeans 
och som 
skärmritaren 
genererar från XML- 
filen. 

Givetvis kan man 
koda med 
beansbinding utan 
att ha en 

skärmritare. Om du 
fäller ut den 
genererade koden 
så ser du hur det 
kan se ut. 


BeansBinding 
Integration i NetBeans 

Skärmritaren i NetBeans IDE har stöd för att skapa beansbinding 
bindningar mellan olika komponenter i skärmen (ett objekt kan vara en 
komponent i skärmen utan att synas). 



5 Form NewJPjncl 
▼ Q Otfxr C om por* rits 


I [Kurstnl 


För att skärmritaren skall hitta objekten måste de skapas genom 
skärmritaren. Det gör man genom att i skärmritaren välja ”Beans > Choose” 
Bean i paletten och sedan skriva hela klassnamnet på klassen man behöver ett 
objekt av. Därefter får man en markör för att placera komponenten i skärmen 
och då kan man klicka var man vill för att skapa komponenten. 

När man gjort det kommer komponenten att skapas i 
den genererade koden och dyka upp i en vy som heter 
inspector i NetBeans som visar skärmens 
komponentträd. 


tntp+ctor 


LJ [JPanel] 

jUbell DUibel) 

D vomeTextFitld [ProSangTextFieldl 




Ev*rm 


Anchor 
Auto Resizmg 
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Formstate revisited 

Nu när vi har automagiskt synkronisering mellan presentationsmodellen och vår 
skärm kan vi dra ytterligare nytta av beansbinding genom ett speciellt formstate som 
använder beansbindings för att upptäcka när något i skärmen ändrats eller är felaktigt. 

BeansBindingFormState tar en BindingGroup som argument till konstruktorn. Matisse 
skapar automatiskt en instans av BindingGroup så fort man skapat en bindning till någon 
egenskap för en komponent i skärmen. 

BeansBindingFormState är också integrerat med hibernate validation så att 
bindningar i en skärm som har ett sådant formstate automatikst valideras on-the-fly och 
valideringsvarningar dyker upp som röda varningsikoner på skärmkomponenten som 
innehåller felet. 


public AddressBookTopComponent() { 
initComponents(); 

FormState formstate = new BeansBindingFormState(bindingGroup); 
setFormState(formState); 

} 


ListState 

Ett ListState håller reda på om något lagts till, tagits bort eller ändrats i en lista. En 
ProSangSimpleList innehåller automatiskt ett sådant liststate efter att den initialiserats. 
ListState är också en implementation av FormState vilket innebär att du i en skärm som 
bara innehåller en lista slipper ha ett eget formstate. 


public AddressBookTopComponent() { 
initComponents(); 


setFormState(mySimpleList.getListState()); 


Substates 

Om du använder en FormState-implementation som heter DefaultFormState kan du 
lägga till ett träd av andra formstates som substates till det. Om någon av substatesen är 
felaktig eller ändrad så bubblar detta upp till vårt formstate. Bra för komplexa skärmar. 


public AddressBookTopComponent() { 
initComponents(); 

DefaultFormState formstate = new DefaultFormState("Main"); // N0I18N 
formstate.addSubState(new BeansBindingFormState(bindingGrou)); 
formstate.addSubState(mySimpleList.getListstate()); 
setFormState(formState); 
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Skärmens livscykel 

Eftersom det går att skapa skärmar på tre tusen sätt är det viktigt att topkomponenterna har 
en livscykel som är likadan för alla skärmar så att det är lätt att förstå hur en skärm fungerar. 
Därför skall du implementera laddning så här: 


När skärmen skapas 


MvProaram 


MvTooComponent 


MvPresenti 

ation Model 


MyTopComponent() 


MyPresentationModelQ 


Koppla ihop listorna 
med skärmkomponenter 

Skapa FormState 

sätt upp tabellformat 

registrera ev. lyssnare 
på modellen 

startPresentationModel(). 


modellnitializedO 


Skapa alla skärmens 
listor som tomma eventlistor 


Gör serveranrop i separat tråd 
och trixar() 


i 


init() med data från servern 


r 


När användaren sedan är klar med skärmen och klickar Ok för att spara sina ändringar skall 
skärmen alltid spara med hjälp av FinalServerOperation och PresentationModel.performFinal(). 

Presentationsmodellen kommer då att skapa en transaktion från klienten så att flera anrop till 
servern knyts ihop till en transaktion samt ha möjlighet att spara transaktionslog och annat som är 
generellt för alla skärmar i hela ProSang. 
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ARKITEKTUR 
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DATAMODELL 



Entiteter 

databas + klasser = sant 

Ett klassiskt problem i objekt-orienterade program som jobbar mot en 
databas är hur skall relationsdatat flyttas fram och tillbaka mellan objekt och 
databasens tabeller. 

Vi använder JPA för detta (Hibernate närmare bestämt). 

JPA går ut på att man mappar klasser mot tabeller och 
relationsdatabasstrukturen. För att kunna använda JPA krävs att man för varje 
post i varje tabell som skall mappas har ett unikt id. I alla nya tabeller 
använder vi ett helt syntetiskt id från en oraclesekvens. 


@Entity 

@Table(name = "ADDRESS") 
public class Address { 

@Id 

(aColumn (name = "ID") 

@GeneratedValue(strategy = GenerationType.AUTO) 
private long id; 


(aColumn (name = "NAME") 
private String name; 


För att jobba mot databasen använder man sedan en EntityManager som 
innehåller metoder för att läsa, skriva, ta bort och söka efter entiteter. Man 
använder ett speciellt query-språk som heter JPQL för att söka efter 
entiteter som innehåller en del finesser som inte finns i SQL men i övrigt är 
ganska snarlikt. 


EntityManager em = ... 

Query query = em.createQuery("SELECT a FROM Address a"); 
List<Address> allAddresses = query.getResultList(); 

query = em.createQuery("SELECT a FROM Address a " + 

"WHERE a.name = :name"); 
query.setParameter("name", "Testa Testsson"); 

Address result = query.getSingleResult(); 
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Serializable 

En inbyggd finess i Java är förmågan att serialisera en objektgraf till XML 
eller tvärtom. Finessen används av Java RMI (Remote Method Invocation) som i 
sin tur är det sätt en klient pratar med en Java EE server över nätverket. 



För att ett objekt av en klass skall gå att serialisera måste det implementera 
ett markup interface som heter Serializable. Det måste också ha ett versionsfält 
för att veta att klassen som objektet serialiserades ifrån är likadan som klassen 
som objektet avserialiseras till.Versionsnummret måste uppdateras varje gång 
du ändrar entitetens fält på något sätt. Om du ändrar metoderna behöver du 
inte räkna upp versionsnummret. 


Att klassen är 
serializable är 
inte direkt 
kopplat till just 
nätverkskommu 
nikation utan 
innebär att 
objekten kan 
skrivas som 
XML till vilken 
ström som helst. 
T.ex. för att 
skriva en lista 
med objekt till 
en fil på 
hårddisken. 


public class Address implements Serializable { 
private static final long serialVersionUID = IL; 
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PersistenceContext 

Attached/Detached 

En mycket viktig skillnad mellan JPA och att läsa och skriva data med SQL är 
begreppet attached.JPA håller ett cache som lever under hela transaktionen. 
Om samma entitet läses flera gånger kommer alla referenser som man får ut 
peka på samma instans av entiteten. 

Så länge entiteten är attached kommer också alla ändringar som görs på den 
att skrivas tillbaka till databasen när transaktionen committas. 


EntityManager em = ... 

em.getT ransaction().begin(); 

Address addressl = em.find(Address.class, 1); 
Address address2 = em.find(Address.class, 1); 
// addressl == address2 

addressl.setName("Nytt namn"); 
em.getT ransaction().commit(); 


Det innebär alltså att man inte kan läsa ut en entitet och sedan använda den 
som någon form av temporärlagring (varför man nu skulle göra det) eftersom 
de ändringar man gör alltid skrivs tillbaka till databasen. 

Om man sparar en ny entitet med EntityManager.persist så kommer 
objektet man skickade in till persist att vara attached efter anropet. Om man 
sparar en gammal entitet med EntityManager.merge så kommer objektet man 
skickade in till merge inte att vara attached, däremot så kommer det sparade 
och attachade objekt returneras. 


EntityManager em = 



em.getTransaction( 

).begin(); 

Address addressl = 

new 

Address(); 

em.persist(addressl); 


addressl.setName(" 

Nytt 

namn"); 

em.getTransaction( 

).commit(); 


När ett objekt serialiseras så kommer det automatiskt att bli detached. 
Objekten serialiseras alltid när de skickas fram och tillbaka mellan server och 
klient. 
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Relationer 

LazylnitializationException 

Halva poängen med relationsdatabas är ju att ha relationer mellan olika 
tabeller. Att varje gång man laddar en entitet läsa ut alla entiteter den har 
relationer med är inte så bra därför lazy-laddas de flesta relationer i ProSang. 

Om man inte annoterar en relation med något så tolkar hibernate det som 
att relationen skall lazy-laddas. 




Så länge en entitet är attached så laddar hibernate automagiskt relationer 
först när man faktiskt använder dem. Om enteteten är detached kan har inte 
hibernate längre någon kontakt med enteteten och man får därför en 
LazylnitializationException. Det innebär att alla relationer som behövs på en 
entitet måste laddas innan den skickas till klienten. 


EntityManager em = ... 

Query query = em.createQuery("SELECT c FROM Company c " + 

"WHERE o C.name = :name"); 
query.setParameter("name", "Databyrån"); 

Company company = query.getSingleResult(); 

List<Employee> employees = company.getEmployees(); 

// lazy load does not happen until here 
int numberOfEmployees = employees.size(); 
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Transaktioner 

JavaEE/JavaSE 

När man använder JPA i JavaSE måste man sköta start, commit och rollback 
av transaktionen själv. I våra tester använder vi JPA i JavaSE miljö men för att 
slippa tänka på transaktionerna så använder vi ett lite färdiga finesser från 
JeeSUnit för att få en ny transaktion i varje test och en rollback efter varje test. 
Om man kodade en JPA-applikation på JavaSE skulle man få lov att göra: 


EntityManager em = 


em.getTransaction() 

■begin(); 

em.getTransaction() 

.commit(); 

em.getTransaction() 

.rollback(); 


I JavaEE sköts transaktionerna av applikationsservern om vi inte annoterar 
våra EJB.er på ett speciellt sätt.Applikationsservern rullar tillbaka transaktionen 
om en EJB-metod kastar ett exception. För många skärmar använder vi nu en 
speciell ServerOperation som startar en transaktion från klienten och knyter 
ihop flera serveranrop i samma transaktion. 

Man kan styra hur EJB-metoderna vill ha sina transaktioner med 
annoteringar men vi gör sällan det. 
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På något ställe i 
ProSang 
använder vi 
pessimistisk 
låsning. T.ex. för 
att garantera att 
det inte blir hål i 
tappningsnumme 
rserierna. 


Optimistisk låsning 

Skydd mot samtidiga ändringar 

Om två användare läser ut samma databaspost och sedan sparar ändringar 
så kommer den som sparar sist skriva över den första användarens ändringar 
utan att någon märker något. 

För att komma runt problemet finns två lösningar. 

Pessimistisk låsning innebär att den första användaren som läser 
posten låser den så att ingen annan kan läsa posten förrän användaren är klar 
och låst upp posten. 

Optimistisk låsning innebär att man på något sätt håller koll på hur 
många gånger en post skrivits eller när en databas post senast skrevs. Innan 
man skriver tillbaka sina ändringar jämför man sin post med den i databasen, 
har den samma antal ändringar alternativt samma ändringsdatum? Då har ingen 
ändrat posten och det går bra att uppdatera. Om antalet skrivningar räknats 
upp eller datumet ändrats till ett senare datum så har någon annan gjort 
ändringar och vi måste avbryta skrivningen. 

IJPA finns stöd för både datum och versions-lösningen.Vi använder 
versionslösninen.Alla nya tabeller i ProSang har alltså en versionskolumn som 
räknas upp varje gång en post ändrats. 


@Entity 

@Table(name = "ADDRESS") 

public class Address implements Serializable { 


(aversion 

private long optlock; 


I praktiken så skapar vi nästan aldrig versionsfältet själva utan får det från en 
basklass som heter DefaultEntity (som också ser till att alla entiteter har ett 
long-id, skapad-data och senast-ändrad-data och en propertyChangeSupport). 


@Entity 

@Table(name = "ADDRESS") 

public class Address extends DefaultEntity 

implements Serializable { 
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Unittester av datamodellen 

Veta att det fungerar utan deploy 

För att kunna testa att datamodellens klasser är rätt mappade, att queryn 
fungerar så använder vi en SQL-databas som skapas av ett testframework som 
heter Jee5Unit. SQL-databasen skapas i arbetsminnet på din dator då det första 
entitetstestet körs och kastas sedan bort när alla tester är klara. 

Ovanpå Jee5Unit har vi skapat ett par basklasser för test som sätter upp 
lite extra data för ProSang (bland annat en fejkad inloggad användare). 

Unittester som testar en entitet genom att läsa och skriva den till databas 
skall heta Klassnamn + EntityTest. 


Jeeöllnit är 
skrivet av Johan. 
Mer info och 
exempel på hur 
man kan använda 
det finns på 
projektsiten: 


public class AddressEntityTest extends EntityTest { 
@Test 

public void testIsPersitableAndReadable() { 
EntityManager em = getEntityManager(); 

Address instance = new AddressO; 
instance.setName("Nisse"); 
em.persist(instance); 

em.flush(); 
em.clearO ; 

Address persisted = em.find(Address.class, 

instance.getld()); 

assertNotNull(persisted); 

} 


Eftersom vi inte kan göra commit på transaktionen (och potentiellt göra så 
att andra tester slutar fungera) så får vi lov att göra lite knep. 
EntityManager.flush() tvingar Hibernate att göra om våra ändringar till SQL och 
trycka dem ut till databastransaktionen, på så sätt fångar vi upp eventuella 
exceptions som är en följd av att vi mappat entiteten felaktigt på något sätt. 

EntityManager.clear() tar bort alla objekt i persistence-contexten så att vi är 
säkra på att när vi sedan laddar den så laddas den från databasen. Om vi inte 
gjorde det skulle EntityManager.find() i exemplet ovan bara returnera en 
referens till instance. 
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Validering 

För att kunna lita på databasens innehåll behöver allt data man får in 
valideras. Istället för att koda sådana krav på alla platser data kan komma in i 
ProSang använder vi ett valideringsframework som heter Hibernate Validation 
och som är tätt knutet till Hibernate. 

På entiteternas fält kan man annotera krav som kommer att undersökas 
automatiskt i skärmarna där beans binding används. Fältens data matchas också 
mot kraven innan en entitet skrivs till databasen. Om något fält är felaktigt när 
databasskrivningen skall ske kastar Hibernate ett exception som rullar tillbaka 
transaktionen. Det blir alltså i praktiken omöjligt att spara felaktigt data genom 
ProSang. 

Fältkraven annoteras till skillnad från entitetsannoteringarna på fältets get¬ 
metod. 


@Entity 

public class Address extends DefaultEntity { 
@Required 

private String name; 

@Length(max = 255) 

@Column(name = "NAME") 
public String getNameO { 
return name; 

} 


Annotering 

Beskrivning 

@Required 

Fältet måste ha ett värde - får inte vara tomt 

@Length(min = , max = ) 

Krav på hur många tecken som får vara i en 
sträng 

@Max(value=) 

Krav på hur högt ett tal i en sträng eller ett 
numeriskt fält får vara 

@Min(value=) 

Samma som ovan fast minsta värde 


Läs om fler inbyggda valideringsannoteringar här: 

http.7/docs.jboss.org/hibernate/validator/3.x/reference/en/html/validator-defineconstraints.html 
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Databasschemat 

XML-representation 

ProSang har vid varje version ett exakt databasschema som matchar de 
entiteter som finns i datamodellen. För att garantera att det är så använder vi 
ett opensource-bibliotek som heter LiquiBase 

Lösningen fungerar såhär: varje gång en databastabell skall skapas eller 
förändras skapar man ett nytt ”changeset” i XML som beskriver en eller flera 
förändringar av databasschemat på ett databasoberoende sätt. Changeset:et har 
ett unikt id som består av ditt användarnamn samt ett strängid och xml-filen 
som det ligger i. Med hjälp av det håller liquibase koll på exakt vilka ändringar 
som applicerats och vilka som är nya. 

Liquibase kan också rulla tillbaka (många) ändringar i efterhand så att det är 
möjligt att köra sin ändring, upptäcka att man gjort fel, rulla tillbaka och rätta 
sin ändring när man sitter och utvecklar. 

För att hjälpa till då man skapar changesets har vi ett eget netbeansplugin 
som gör att man kan högerklicka på en entitet och få ut ett LiquiBase- 
changeset som beskriver hur tabellen skall se ut. 


& Database Schema Autopatch 

► Qj Source Pack ages 

► Qd Test Packages 
▼ Cd Other Source s 

▼ ca src/main/resources 

► Ö META-WF 

► 99 se databyTan.prosang.server.autopatch.postpatch 

► td se.databyran.prosarvg.server.autopatch.sql.patches 
▼ LJ se.databyran.prosang.server.dbschema 

£>] changelog-2011.5.1.xml 
1 master.xml 


För att 

säkerställa att 
schemauppdateri 
ngen gått klart 
innan ProSang 
startar så körs 
schemauppdateri 
ngen med hjälp 
av egna JBoss- 
services som 
sedan alla 
fasadbönor har 
ett beroende på. 


Mer information om pluginet hittar du på wikin: http://wiki.databyran.se/ 
display/psdev/Databasschemahantering 
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Databasschemat 

Deprecated:Generera DDL från klasser 

Det här gäller ProSang före version 2011.5 då vi gick över till LiquiBase (se 
föregående sida). Det är kvarlämnat som en referens. 

ProSang har vid varje version ett exakt databasschema som matchar de 
entiteter som finns i datamodellen.Vi kan generera DDL från annoteringarna i 
våra klasser men vi kan inte applicera dem automatiskt. En del 
databasschemadetaljer som t.ex. index finns dessutom inte alls i entiteterna och 
måste läggas till för hand. 

Lösningen fungerar såhär: varje gång en databastabell skall skapas eller 
förändras skapar man en ny databasschemapatch som placeras i en speciell 
katalog. Nästa gång ProSang deployas på servern kommer patchen köras. Ett 
speciellt bibliotek håller reda på vilka patchar som gått och vilka som är nya så 



► Ld Source Packages 

► Ld Test Packages 
▼ Cd Other Sources 


▼ Cd src/matn/resources 

► tid <default package> 

► £ META-INF 

▼ l se.databyran.prosang.server.autopatch.sql.patches 
Lj patch.list 

jä] patchOOOljntnal-schema.sql 
j£ patch0002_blood bank view.sql 
ig] patch0003.cbent-settings-lite.sql 
d[ patch0014_code-definition.sql 

patchOO 1 S.bloodbank-donationsite.sql 
j£ patch0016_donor.sql 
J] patch0017_alert-code-definition.sql 
patch0018.alert.sql 
j3] patch0019.propchange.sql 
patch0020.enum-defmitton.sql 
j£ patch0021.donor-extended.sql 
ig] patch0022_donor-additional-donatk>n-site.sql 
jg patch0023.donor-additiorval-donor-tvpe.sql 
patch0024.donor-invitattonrules.sql 
£ patch002S.cbentsetttngs.sql 
j£ patch0026.person-identity.sql 
_ [g] patch0027_global-alert.sql _ 


För att generera databasschema från datamodellen högerklickar du på 
datamodellsprojektet, väljer ”Custom > Generate DDL”, maven kommer då 
generera en DDL för hela datamodellen som dels skrivs ut i NetBeans 
logfönster och dels hamnar i en fil. 

Du får själv leta fram de ändringar du skall ha i din patch. 


35 





ProSang introkurs 


Fasadbönor 

Läsa och skriva entiteter utifrån 


«lnterface» 
GenericFacade<E, l> 

£ 


-| AddressFacadeBean 


AddressFacadeLocal 




«Abstract» 
GenericFacadeBean<E, l> 

5 


För att undvika att logik som läser och skriver entiteter sprids genom hela 
ProSangservern har varje viktig entitet en fasadböna som resten av ProSang använder för att 
läsa och skriva entiteter av den typen. Eftersom JPA:s queryspråk inte är typsäkert ger det 
också ett extra skydd vid refaktorering - det är hyffsat lätt att hitta alla JPQL-queries som 
görs mot en specifik entitet. 

Ett antal operationer (CRUD) är generella och finns färdigimplementerade i en abstrakt 
basklass som heter GenericFacadeLocal. Metodsignaturerna för dessa finns också i ett 
generellt interface som du låter ditt EJB-interface uttöka. 

Krångligare operationer som sökningar t.ex. ges en egen metod i fasad-EJB:n. 

Fasad-EJB.erna är alltid bara lokala och kan inte anropas från en extern klient till 
ProSangservern. 


@Local 

public interface AddressFacadeLocal extends GenericFacade<Address, Long> { 
List<Address> findSpecialAddresses(); 

} 

@Stateless 

public class AddressFacadeBean extends GenericFacadeBean<Address, Long> 

implements AddressFacadeLocal { 
public List<Address> findSpecialAddresses() { 

} 

} 


36 


















ProSang introkurs 


AFFÄRS 




Affärslogiken är det som knyter ihop flera fasadböneanrop till 
affärsmetoder som publiceras till klienten. Ibland kan affärslogiksbönorna till 
en början vara enkla delegat som bara upprepar metoder från fasadbönorna. 
Ofta kan det vara bra att knyta ihop upprepade anrop av en fasadböna till ett 
enda anrop på en affärslogiksböna. 

Fasadbönorna som en affärslogiksböna använder injiceras automatiskt av 
applikationsservern när vi annoterar dem med @EJB 

Alla våra affärslogiks EJB:er är remote-bönor och måste därför annoteras 
med en behörighetsannotering som styr vem som får anropa dem. Med några 
få undantag kräver alla våra remote-EJB.er att man klienten är inloggad och 
annoteras därför med krav på rollen ”user” (om man inte annoterar sin EJB 
med behörighet kan vem som helst ropa på metoderna i den). 


@Remote 

public interface AddressRemote { 

/** 

* Save all addresses in the list and return true 

* if the save was successful 

*/ 

boolean saveAddresses(List<Address> addresses); 

} 


(aStateless 

@RolesAllowed("user") 

public class AddressBean implements AddressRemote { 

@EJB 

private AddressFacadeLocal addressFacade; 

public boolean saveAddresses(List<Address> addresses) { 
for (Address address : addresses) { 
if (address.getld() == 0) { 

addressFacade.insert(address); 

} else { 

addressFacade.update(address); 

} 

} 

return true; 

} 

} 
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Unittester av affärslogiken 

Testa utan datamodellen 

När man testar affärslogiken så vill man inte att testerna skall fela på grund 
av ett fel i en fasadböna. Man vill faktiskt bara testa just den logik man skrivit i sin 
affärsmetod. 

För att åstadkomma ett sådant test använder vi ett mock-framework som 
heter JMock som fungerar lite som en skådespelare. Man ger ett interface till 
JMock och säger, låtsas att du är en implementation av det här interfaces. Sedan 
ger man ett manus (Expectations) till JMock där man beskriver hur man 
förväntar sig att någon kommer använda implementationen. 

För att få sin skådespelarklass injicerad i sin EJB-klass som om den var 
deployad på en applikationsserver låter vi vårt test ärva EJBTestCase och 
använder metoderna injectEJBQ samt getBeanToTestQ. 


public class AddressBeanTest extends EJBTestCase<AddressBean> { 

public void AddressBeanTest { 
super(AddressBean.class); 

} 

@Test 

public void testSaveAll() { 

Mockery mockery = new MockeryO; 

final AddressFacadeLocal mockedAddressFacade = 

mockery.mock(AddressFacadeLocal.class); 

List<Address> addresses = new ArrayListO; 
addresses .add(new AddressO); 
addresses.add(new AddressO); 

mockery.checking(new Expectations() { 

{ 

exactly(2).of(mockedAddressFacade). 

save(with(any(Address.class)); 
will(returnValue(Boolean.TRUE)); 

} 

} 

injectEJB(AddressFacadeLocal.class, mockedAddressFacade); 
AddressBean instance = getBeanToTest(); 

boolean result = instance.save(addresses); 

assertTrue("Expected save to return true on success", result); 
mockery.assertlsSatisfied(); 
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UTSKRIFTER 



ProSangs utskriftspaket använder iReports/JasperReports som är ett 
rapportverktyg som är integrerat med NetBeans. Man ritar alltså sina 
utskrifter inuti NetBeans. 

Kring utskrifter finns ett par viktiga begrepp: 

• rapporttyp en klass som innehåller logiken som tar fram och 
förbereder data för rapporten, klassen innehåller också en lista med de 
rapporter som man kan använda för att skriva ut rapporttypen 

• rapport själva layouten för en utskrift, kan finnas flera för en 
rapporttyp 

• utskrift data från en rapportklass kombinerat med en rapport färdigt 
för att skriva ut. 

• ReportRequest knyter ihop en rapporttyp, vilken rapport som skall 
användas samt eventuella parametrar till rapporttypen (t.ex. vilken givare 
som skall skrivas ut) 

Klienten ropar på PrintRemote med en ReportRequest och servern 
generar sedan utskriften som den skickar tillbaka till klienten så att utskriften 
köas genom klientendatorns utskriftssystem. Servern känner alltså inte till 
något om vilken skrivare som används. 

Rapporttyperna och rapporterna finns i modulen Server Print Package. 


▼ ^ Server Print Package 
▼ OJ Source Package v 

► Bb se .databyran. pr osang. se rver. printing 

► a se .databyran. prosang. server. pnnting.donaton 


se. daubyran.prosang.se rver.printing.donatton.donafontabels 


ä] DonatontabelsControlReport.java 
DonatonLabelsNe^DofiorReport.java 
Äj DonaiiontabelsNewOonorRequest.java 
dg DonationtabelsRepon.java 
Äj Dona ton La be Is Re q ue st j a va 
dt] DonatonlablesControlRcquest java 
package-Info.java 

► ttj se. databyran. prosang. se rver. prmting.donaton.lists 

► a se.databyran. prosang. se rver. printing.donor 

► ® se.databyran. prosang.se rver. printing.donor.lener 

► yy se.databyran. prosang. se rver. printing.dynamic 

► Lii se.databyran.prosang.server.printing.renderer 

► se.databyran.prosang.server.printing.tesi 
► Ljä Test Packages 

▼ Cc OtNer Sources 

▼ C3 src/mam/resources 

► ttl <defau!t package> 

► Q META-INF 

► a teports 

► a reports.Common 

▼ a reports.DonationLabels 
[_J Donatontabels.jnmil 


39 








ProSang introkurs 


TRANSAKTIONSLOG 



I ProSang behövs väldigt finkornig spårbarhet på ändringar. Alla operationer 
som måste vara spårbara skrivs till transaktionsloggen. Operationer som skall 
var spårbara kan vara att ett visst fält på en entitet ändrats, att en rapport 
skrivits ut eller att användaren forcerat någon form av varning. 

Datamodellen 

Entiteter kan själva hålla reda på om vissa fält ändrats. Genom att sedan låta 
dem implementera SelfLoggingEntity kan man skicka själva instansen till 
fasadbönan LogFacade. Man kan t.ex. göra det från insert och update på 
fasadbönan för entiteten. 

Den här typen av loggning är enklast att implementera för rot-entiteter 
som man alltid jobbar direkt med. Entiteter som sparas med Cascade är svårt 
att hantera på detta sätt. 

Affärslogiken och fasadbönorna 

Man kan skapa Logltems direkt i sin kod på servern och skicka till 
LogFacade. 

Klienten 

I klienten vill man oftast bara spara Logltems om användaren sparar sina 
ändringar. Därför är det bäst att skapa en LogHandler i sin presentationsmodell 
som man sedan ger Logltems när saker som skall transaktionsloggas händer. 
När sedan skärmen kör sin FinalServerOperation så ger man listan med 
logitems från sin LogHandler till sin FinalServerOperation så sparas de 
automatiskt. 
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I ProSang har funktionstester som testar hela applikationen från 

användargränsnitt i klienten ner till databasen genom en deployad server. 
Testfallen skrivs som vanliga unittester i modulen Client Modules/Client 
Application. 

Testerna fungerar som om det var en användare som körde systemet. 
För varje swing-komponent finns en Operator-klass som vet hur man 
jobbar med en sådan komponent. 
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JBOSS 



Hos varje kund är förutsättningarna för integration med andra system och indatakällor olika. 
Det kan t.e.x. vara vad kunden köper för typ av utgående SMS-tjänst, olika SMS leverantörer har 
helt olika sätt att skicka SMS. Någon har en webtjänst, någon har en HTTP-server som tar 
meddelandet som GET argument i en URL. 

För att slippa göra en version av ProSang per kund är denna integration externaliserad med 
hjälp av JBossESB (JBoss Enterprise Service Bus).Varje ingående och utgående datakoppling är en 
”tjänst” som deployas på JBoss-servern. ESB-tjänsterna kataloger istället för jar-arkiv och läggs 
precis som allt annat som deployas på en JBoss-server i deploy-katalogen. 


ProSang 2008.8 
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En ESB-tjänst börjar med en gateway där data kommer in på något sätt. 
Det kan vara en webbtjänst, en katalog där filer placeras, en plats på en FTP- 
server där filer placeras, m.m. Man kan också explicit anropa en viss ESB från 
sin javakod.Alla sådana anrop sker i ProSang ifrån lokala EJB:er i prosang- 
outgoing-connections.jar så att själva ProSang inte behöver känna till JBossESB 
på något sätt. 

Efter detta består ESB-tjänsten av en eller flera Actions som skall bearbeta 
datat eller publicera datat någonstans. Exempel på en action kan vara XSLT- 
transformation av XML, att skriva till ett loggningsarkiv eller använda datat 
som argument till ett EJB-anrop. Ett antal färdiga ESB-actions är inbyggda i 
JBoss ESB och vi har ett eget bibliotek med några egna actions. I första hand 
använder ESB-tjänster färdiga actions som konfigureras på olika sätt. 

* 



<■ 


SMS-leverantör 


▼ L. prosang-sms.esb 
► Cl examples 
▼ META-INF 

o deployment.xml 
g| jboss-esb.xml 


En ESB-tjänst består i filsytemet av en katalog som 
slutar på .esb i den finns en META-INF-katalog som i sin 
tur innehåller filen jboss-esb.xml som innehåller tjälva 
tjänstekonfigurationen och ibland deployment.xml som 
listar tjänstens beroenden på andra typer av tjänster i 
samma server. 
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JBOSS-ESB 




Det här exemplet är ProSangs utgående SMS-koppling. Attributet invmScope säger åt JBoss 
ESB att skapa en ingående kanal för anrop från samma JVM, det är den kanalen vi ropar på från 
prosang-outgoing-connections. 


<?xml version = "1.0" encoding = "UTF-8"?> 

<jbossesb 

xmlns=" http: //anonsvn.labs.i boss.com/labs/ibossesb/trunk/product/etc/schemas/xml/ 
1bossesb-1.0.1.xsd " 

parameterReloadSecs="5"> 

<! - - 

This is an example format that just writes the SMS request to an archive in 
the tmpdir of the machine the server runs on. 

This is meant for testing on devel machines. See examples/ for actual 
production configuration samples. 

- - > 

<services> 

<service category="ProSang" 
name= M SMS" 

description= M ProSang outgoing SMS service" 
invmScope="GLOBAL"> 

<!-- the mep attribute is what JBoss ESB looks at to know if we 

extect some kind of status/answer when the service has handled 
a message --> 

<actions mep="OneWay"> 

<action name="debug M class="org.j boss.soa.esb.actions.SystemPrintln"> 
<property name="printfull" value= M false M /> 

<property name="message" value="Value from getMessage" /> 
</action> 


<!-- Transform the ProSang-Java SMS object into XML --> 

<action name="transformToXML" 

class="org.j boss.soa.esb.actions.converters.Obj ectToXStream"> 
<property name="exclude-package M value="true" /> 

</action> 


<!-- archive message under your tmp directory --> 

<action name="archive" 

class="se.databyran.esb.actions.ArchiveWiretap"> 

<property name="baseDirectory" value="${ProSangHome}/archive"/> 
<property name="serviceName" value="outgoing-sms"/> 

</action> 

</actions> 

</service> 

</services> 

</jbossesb> 
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APIÖ' 



I ProSang finns sjutusen olika små APker för olika saker. Här är några: 

Finder-API 

API för sökdialoger som används för att välja t.ex. givare att öppna i ett 
program eller tillsammans med ProSangFinderField i en skärm där man vill 
kunna välja en entitet bland många. Ligger i Client Modules/Core Cluster/Core 
Search API. Exempel på implementationer finns i Client Modules/Donor 
Cluster/Donor Common 

Sökparameter-API 

API för att representera ett JQPL-sökargument med en klass som kan 
kombineras med andra sökargument som söker efter samma typ av entitet. 
Ligger i datamodellen i paketet se.databyran.prosang.model.core.search och 
exempel på implementationer finns i se.databyran.prosang.model.donor.search. 

Matchat med detta finns också ett sökpanels-API i klienten som gör att man 
enkelt kan skapa ett program som tillåter användaren att kombinera enskilda 
sökparametrar till mer komplexa sökningar. Det kan du hitta i projektet Client 
Modules/Core Cluster/Core Dynamic Search API 

Notifierings-API 

API för att visa att en Swing-komponent innehåller felaktiga värden. Ligger i 
ProSang Libraries/ProSang GUI-lib där både API och ett antal implementationer 
ligger. Innehåller interfacet Notifiable som BeansBindingFormState använder för 
att varna om fel och som du också använder om du vill kunna utföra mer 
komplex validering i din presentationsmodell. 


Presentationsmodells-API 

Basklasser för presentationsmodeller. Ligger i Client Modules/Core Cluster/ 
Core Util 

DateSpan och Datum-API 

API för att jobba med datum och tidsperioder. Ligger i ProSang Libraries/ 
ProSang Utils. Intressanta klasser är DateUtil, DateFormatUtil och DateSpan. 

EntityDisplayer-API 

SPI för att utan att känna till vem som visar en entitet be någon annan att 
visa den. Gör det möjligt att registrera en EntityDisplayer för en viss 
entitetsklass för andra att använda. Ligger i Client Modules/Core Cluster/Core 
Util och paketet se.databyran.prosang.client.core.util.spi 
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